Dynagraph Card Data Group
The IoT Sparkplug EIE "Dynagraph Card" (DynaCard) data group enables the retrieval of dynagraph card data that corresponds to a subscription to an MQTT topic. "Dynagraph Card" data groups for the IoT Sparkplug EIE subscribe to data published by an MQTT server.
Note: The IoTSparkplug_POC sample device template file includes the "Dynagraph Card" (DynaCard) data group and requires specific attributes and values. For more information, see IoTSparkplug_POC.dtf.
The IoT Sparkplug EIE "Dynagraph Card" data group supports nine card types. Each type and its associated ordinal number are:
- 0 — Current Card: Specifies the most recent stroke.
- 1 — Shutdown Card: Specifies a card when a normal pump-off is detected.
- 2 — Pumpup Card: Specifies a card when a unit starts again after having "pumped up".
- 3 — Reference Card: A quick reference or snapshot of a dynagraph card. Results from clicking the Save Reference button.
- 4 — Start Card: Specifies a card taken when a unit is configured. Used as a baseline.
- 5 — Ideal Card: Specifies
- 6 — Alarm Card: Specifies a card created whenever an alarm condition is met in a field device. Such a condition is typically treated as less severe than a fault, which creates a failure card.
- 7 — Failure Card: Specifies a card created whenever a fault condition is met in a field device. Such a condition is typically treated as more severe than an alarm, which creates an alarm card.
- 99 — Custom Card: Specifies one of the custom IoT Sparkplug-specific card types.
Dynagraph Card Topic Requirements
The "Dynagraph Card" data group has specific requirements for fields in the Topics section of the Data Group Properties dialog.
- For all DynaCard types except for the Reference Card, the three ID fields in the Topics section are required fields.
- For the Reference Card type, the requirements for the Group ID, Edge node ID, and Device ID fields are either all three fields must be blank, or all three fields must have entries. A combination of blank fields and entries in fields is not permitted for Reference Card types.
DynaCard Transaction Types
The IoT Sparkplug EIE can subscribe to DynaCard transactions from Link. The source of the data comes from either the DDS or the VHS DynaCard library used by the ForeSite Product Optimization Platform. Both sources must use the Sparkplug B payload format for the IoT Sparkplug EIE to be able to consume the data.
If subscribing to DynaCard transactions originating from a CygNet DDS, the IoT Sparkplug EIE can consume data published only in raw XML format. If subscribing to DynaCard transactions originating from the VHS DynaCard library, the IoT Sparkplug EIE can consume data published in the Weatherford DynaCard protobuf format. Either type of transaction will be written as a DDS transaction on a DynaCard data group.
